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About This Guide 


Before running any application on servers in a Novell® Cluster Services™ cluster, the application 
must be installed and configured properly to take advantage of shared storage and to achieve high 
availability. This document provides information to help you set up and configure some of the 
applications commonly used in a NetWare® 6.5 environment. See the Novell Cluster Services 
Overview and Installation documentation for cluster installation and configuration, and see your 
application documentation for specific application installation and setup instructions. 


Documentation Updates 


For the most recent version of the Novell Cluster Services 1.7 Resource Configuration Guide, see 
the latest NetWare 6.5 documentation (http://www.novell.com/documentation/lg/nw65/ 
index.html). 


Documentation Conventions 


In this documentation, a greater-than symbol (>) is used to separate actions within a step and items 
in a cross-reference path. 


A trademark symbol e, TM, etc.) denotes a Novell trademark. An asterisk (*) denotes a third-party 
trademark. 
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Configuring NSS Mirroring with Novell Cluster 
Services 


NSS mirroring is a checkpoint based synchronous mirroring solution. Data blocks are written 
synhronously to multiple storage devices. It is an alternative to SAN array based synchronous 
replication options. 


Hardware configuration and placement for NSS mirroring can vary depending on geography and 
fault tolerance requirements. For example, the following figure depicts a simple hardware 
configuration in which one side of the mirrored NSS volume is located in a separate building from 
the rest of the cluster hardware. Should a disaster occur in one building, data would still be safe on 
the mirrored NSS volume in the other building. 


Figure 1 Single Cluster with Mirrored NSS Volumes in Separate Buildings 
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The following figure depicts a more complex hardware configuration in which two clusters are 
placed in separate buildings, but each has one side of a mirrored NSS volume in the building with 
the other cluster. Should a disaster occur in one building, data would still be safe and immediately 
accessible on the mirrored NSS volume in the other building. 
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Figure 2 Two Clusters with Mirrored NSS Volumes in Separate Buildings 
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Configure NSS Mirroring 


NSS partitions must be mirrored after they are created. If you have an existing partition that you 
want to mirror, you can either create another partition of equal size on another device to mirror the 
first partition to, or let the mirroring software automatically create another partition of equal size 
on another device. 


Novell® Cluster Services™ should be installed and running prior to creating and mirroring 
partitions on shared storage. 


When you create a Novell Cluster Services system that utilizes shared storage space (a Storage 
Area Network or SAN), it is important to remember that all servers attached to the shared device, 
whether in the cluster or not, have access to all of the volumes on the shared storage space unless 
you specifically prevent such access. Novell Cluster Services arbitrates access to shared volumes 
for all cluster nodes, but cannot protect shared volumes from being corrupted by noncluster 
servers. 


Create and Mirror NSS Partitions on Shared Storage 


Prior to creating and mirroring NSS partitions on shared storage, ensure that you have 
+ NetWare® 6.5 installed on all servers that will be part of the cluster 


+ All servers in the cluster connected to a shared storage system 
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+ One or more drive arrays configured on the shared storage system 


+ Atleast 15 MB of free space on the shared storage system for a special cluster partition 


To create and mirror NSS partitions complete the following: 
1 Start NSSMU by entering NSSMU at the server console of a cluster server. 
2 Select Partitions from the NSSMU main menu. 


3 Press the Insert key and select the device on your shared storage system where you want to 
create a partition. 


If a device is marked as sharable for clustering, all partitions on that device will automatically 
be sharable. 


Device names are not changeable and might be labeled something like 0x2 or 0x1. 


If Cluster Services was previously installed and shared disk partitions were already created, 
the Partitions List will include this information. 


4 Select NSS as the partition type, then specify the parition size and, if desired, an NSS pool 
name and label. 


If you specify a pool name, a pool by that name will automatically be created on the partition. 
If no pool name is specified, you will have to create a pool on the partition later. 


4a Ifyou chose to create a pool, choose whether you want the pool to be activated and cluster 
enabled when it is created. 


The Activate on Creation feature is enabled by default. This causes the pool to be 
activated as soon as it is created. If you choose not to activate the pool, you will have to 
manually activate it later before it can be used. 


The Cluster Enable on Creation feature is also enabled by default. If you want to cluster 
enable the pool at the same time it is created, accept the default entry (Yes) and continue 
with Step 4b on page 11. If you want to cluster enable the pool at a later date, see the 
Novell Cluster Services 1.7 Administration Guide for more information. 


4b Specify the Virtual Server Name, IP Address, Advertising Protocols and, if necessary, the 
CIFS Server Name. 


When you cluster enable a pool, a virtual Server object is automatically created and given 
the name of the Cluster object plus the cluster-enabled pool. For example, if the cluster 
name is cluster! and the cluster-enabled pool name is pooll, then the default virtual 
server name will be cluster! pooll server. You can edit the field to change the default 
virtual server name. 


Each cluster-enabled NSS pool requires its own IP address. The IP address is used to 
provide access and failover capability to the cluster-enabled pool (virtual server). The IP 
address you assign to the pool remains assigned to the pool regardless of which server in 
the cluster is accessing the pool. 


You can select one or all of the advertising protocols. NCP is the protocol used by Novell 
clients, CIFS is the protocol used by Microsoft clients, and AFP is the protocol used by 
Macintosh clients. Selecting any of the protocols will cause lines to be added to the pool 
resource load and unload scripts to activate the selected protocols on the cluster. This lets 
you ensure that the cluster-enabled pool you just created is highly available to all your 
clients. 


Configuring NSS Mirroring with Novell Cluster Services 11 


If you select CIFS as one of the protocols, a CIFS Server Name is also required. This is 
the server name CIFS clients see when they browse the network. A default server name 
is listed, but you can change the server name by editing the text in the field. 


4c Select Create to create and cluster enable the pool. 


5 Select the partition you want to mirror (this may be the partition you just created) and press 
the F3 key. 


6 Select the device with free space or the partition you want to mirror to, and then select YES 
to mirror the partition. 


To ensure disaster recovery, the device you select to mirror should be in another storage array. 


Create an NSS Pool and Volumes 


Once an NSS partition has been created and mirrored, if you have not already done so, you must 
create an NSS pool and volume on that partition. To do this, follow the instructions in "Create NSS 
Pools " in the Installation and Setup section of the Novell Cluster Services Overview and 
Installation documentation. 


Novell Cluster Services Configuration and Setup 


After configuring NSS mirroring and creating a pool and volume on the mirrored NSS partition, 
if you did not cluster enable the NSS pool on the mirrored partition when you created it, do so by 
following the instructions in the Installation and Setup section of the Novell Cluster Services 
Overview and Installation documentation. 


When you cluster enable a shared disk pool, the commands to start and stop the pool resource are 
automatically added to the resource load and unload scripts. 


Check NSS Volume Mirror Status 


Once you have configured NSS mirroring with Novell Cluster Services, you should check to 
ensure that it is working properly in a cluster environment. 


1 Ensure that the volumes on the cluster-enabled pool are mounted on an assigned server by 
entering volumes at the server console. 


2 Check the mirror status of the mirrored partition by entering mirror status at the server 
console of the server where the NSS pool on the mirrored partition is active. 


After entering mirror status, you should see a message indicating that mirror status is 100 
percent or a message indicating that the mirrored object is fully synchronized. 


3 Migrate the pool to another server in the cluster and again check to ensure the volumes on the 
pool are mounted by entering volumes at the server console. 


4 Check the mirror status of the partition again by entering mirror status at the server 
console. 


Additional Novell Cluster Services Configuration Information 


For additional information on setting up and configuring Novell Cluster Services, see the Novell 
Cluster Services 1.7 Administration Guide. 
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Configuring Web Search and Novell Cluster 
Services 


The NetWare® Web Search Server Synchronization feature provides both a fault-tolerant and load- 
balanced environment. Therefore, it is unnecessary to set up Novell® Cluster Services™ for use 
with Web Search. However, if you want to include failover capabilities, then you might consider 
using it. 


Setting Up Web Search with Novell Cluster Services 
Installing and configuring NetWare™ Web Search Server for use with Novell Cluster Services 
requires three primary steps: 


1. Setting up your clustered environment, which includes the Apache Web server and the Tomcat 
servlet container (both of these are typically installed and configured by default). 


2. Installing Web Search Server to the same shared volume from each of your clustered servers. 


3. Creating virtual search servers using the DNS name and IP address of your cluster server. 


Step One: Setting Up Your Clustered Environment 


Before NetWare Web Search Server will run in a clustered environment, you must install and 
configure the following components on a server in your cluster. 


A Novell Cluster Services 
See "Installation and Setup". 
O Apache Web Server 


See "Configuring Apache with Novell Cluster Services". 


O Tomcat Application Server 


See "Configuring Tomcat with Novell Cluster Services". 


Step Two: Installing Web Search Server to a Shared Volume 


Install Web Search Server (using the NetWare 6.5 Installation CD) to the same shared volume in 
your clustered environment. For information about setting up a shared volume in a clustered 
environment, see Cluster Enable Pools and Volumes in the Novell Cluster Services 1.7 
Administration Guide. 


Installing Web Search Server to each server in your cluster allows the installation program to 
correctly register Web Search with each of your server's Web and application servers. 


Installing it to the same shared volume centralizes all of the reguired templates, indexes, and 
configuration settings for use by all servers in your cluster. Each time you create a new virtual 
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search server, default settings and templates are drawn from the shared volume. Future upgrades 
or patches to the Web Search Server need to be installed only to the shared volume and can be done 
from any server in your cluster. 


Step Three: Creating Virtual Search Servers 


You can now begin creating virtual search servers from any of the Web Search Servers in your 
cluster. 


When prompted to provide a name and alias for your new virtual search server, enter the DNS 
name and IP address (alias) of your cluster server. The Path field can be left blank because it is 
already known by Web Search Server. 


If You Are Not Using a Shared Volume 
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We recommend that you use a shared volume. However, if for some reason your clustered 
environment is not utilizing a shared volume, you can install Web Search Server to each of your 
servers and then use Web Search Synchronization to keep the configuration settings and indexes 
up-to-date across all of your servers. 


If you do this, each time you upgrade or apply a patch to the Web Search Server, you will need to 
repeat the upgrade installation or patch on each of the servers in your cluster. 
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Configuring Tomcat with Novell Cluster 
Services 


Tomcat is a JSP-supported servlet engine that, by default, is installed with NetWare® 6. Tomcat 
runs on a Web server and compiles JSP (Java* Server Page) files whose output is HTML code 
when displayed in a browser. 


If your Web server is running Tomcat in a clustered environment, some addtional configuration is 
required. 


This documentation assumes that you already have Novell® Cluster Services™ installed and 
running on your network. 


Configuring Tomcat 


1 Locate the class files that are required to run your Web site, then copy these files to the same 
directory on each Web server in the cluster. 


This directory can be anywhere that you choose. For example: 
sys:\Your Web Site Name 


2 Choose any Web server in the cluster and edit the sys:\tomcat\33\bin\tomcat33.ncf file by 
adding a new line to the -classpath parameter. This new line should point to the directory 
where you copied your class files in Step 1. 


For example: 
envset TOMCAT CLASSPATH=$TOMCAT CLASSPATH; SYS:|Your Web Site Name 


3 Copy the edited .ncf file (from Step 2) to the sys:\tomcat\33\bin directory of every Web server 
in the cluster. 


4 Create an NWAPPS-any name.XML file in the sys:\tomcat\33\conf directory of any Web 
server in the cluster, then put the path to your Web site in this file. 


This path sets the Tomcat context. Tomcat will service only those reguests that originate at or 
below this context. 


For example, if you put all of your Web and JSP files in the same directory, which you called 
sys:| Your Web Site Name, you would enter a slash for the Context path and 
sys:| Your Web Site Name for the docBase. 


The context path is the path that you need in order to access your Web files from a browser 
and the docBase is the path that you need in order to access the Web files on your hard drive. 


To see an example of what this .xml file should contain, go to the CONF directory of your 
NetWare 6.5 server and open the apps-example.xml file. If you need more explanation of how 
to use the elements in the example .xml file, see the FAO document located in the 
sys:\tomcat\33\doc directory. 
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5 Copy the .xml file (from Step 4) to the sys:\tomcat\33\conf directory of every Web server in 
the cluster. 


6 At the server console of every Web server in the cluster, enter tomcat 33 -stop to stop the 
Tomcat service. 


7 Wait approximately 15 seconds for the cleanup operations to finish. 


8 At the server console of every Web server in the cluster, enter tomcat33 to restart the 
Tomcat service. 


Tomcat is now configured to run with Novell Cluster Services. 
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Configuring Apache with Novell Cluster 
Services 


There are obvious advantages to clustering your Apache Web servers. Not only will your 
customers appreciate the high availability of your Web content, but they will also no longer bear 
the brunt of a Web server failing or going down for maintenance. With Novell® Cluster Services™, 
if your Web server fails, you can use any of the servers in the cluster to host your Web site, which 
results in virtually zero down-time for your customers. 


Before Apache and Novell Cluster Services can work together, there is additional configuration 
that needs to take place when you are installing and configuring both Novell Cluster Services and 
Apache. 


Apache Configuration 


When you install NetWare® 6 or 6.5, Apache is installed by default. However, if you select the 
Pre-Migration server option while installing Netware 6, Apache is not installed by default. 


Novell Cluster Services Configuration and Setup 


1 Create an NSS pool or use an existing pool. 


For more information on creating pools, see the Novell Cluster Services Overview and 
Installation Guide (http://www.novell.com/documentation/lg/ncs6p/index.htm!l). 


2 Create an NSS volume on a pool. 


If a pool already exists, make sure there is enough space on the pool for the NSS volume that 
you plan to make. 


For more information on creating NSS volumes, see the Novell Cluster Services Overview 
and Installation Guide (http://www.novell.com/documentation/lg/ncs6p/index.html). 


3 Cluster-enable the pool you created in Step 2. 


Cluster-enabling the pool automatically custer-enables the NSS volume that you created on 
the pool. 


When you cluster-enable a pool, this allows you to access the cluster enabled volumes through 
a NetWare client. This step involves assigning an IP address. Remember this IP address 
because you will need it later in the configuration. 


For more information, see the Novell Cluster Services Overview and Installation Guide (http:/ 
/www.novell.com/documentation/lg/ncs6p/index.html) > Installation and Setup > Setting Up 
Cluster Services. 


4 Put your Web content on the cluster-enabled volumes that you enabled in in Step 3. 
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5 Choose a server in the cluster and edit the httpd.conf file, located in the sys:\apache\conf 
directory. 


Make the following two modifications to the httpd.conf file: 


+ Set the value of the ServerRoot parameter to the directory where you placed your Web 
content in Step 4. (The default value of this parameter is SYS:\APACHE.) 


For example, if you placed your Web content in sys:/Apache, the ServerRoot parameter 
would look like this: 


ServerRoot “SYS:\APACHE” 


+ Uncomment the Listen parameter, then add the IP address that you assigned to your 
cluster-enabled volumes in Step 3 to that parameter. 


6 Copy the edited httpd. conf file to the sys:\apache\conf directory on every server in the cluster. 
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Configuring DHCP with Novell Cluster Services 


Benefits of Configuring DHCP for High Availability 


A NetWare® 6.5 DHCP server automatically assigns IP addresses and other configuration 
information to clients upon request or when the clients are restarted. If for some reason the 
NetWare 6.5 DHCP server is not accessible, clients lose their ability to connect to the network 
because they cannot obtain an IP address. Configuring DHCP with Novell® Cluster Services™ 
ensures the IP address range required by users to connect to the network is highly available. This 
is possible because DHCP configuration information and IP address ranges are stored in Novell 
eDirectory™ and the DHCP server is automatically started, stopped, and restarted on different 
servers in the cluster by Novell Cluster Services. 


DHCP Installation and Configuration 


Novell Cluster Services (NCS) 1.7 must be installed before configuring DHCP. NCS 1.7 provides 
a DHCP resource template, which facilitates configuring DHCP ina cluster environment. NetWare 
6.5 includes NCS 1.7 and licenses for two cluster nodes. 


Before running DHCP with Novell Cluster Services, DHCP must be configured properly on one 
server in the cluster. To see DHCP documentation for instructions on installing and configuring 
DHCP with NetWare 6.5, go to the Novell DNS/DHCP Services Administration Guide for NetWare 
6.5. 


DHCP server software is included with NetWare 6.5. You must select the Customized NetWare 
Server installation option and check the Novell DNS/DHCP Services component check box or the 
DNS/DHCP Pre-Configured Server option to install DHCP during the NetWare 6.5 installation. 
You cannot install DHCP with the Basic NetWare File Server installation option. You will need to 
configure DHCP after your NetWare 6.5 server is installed. And, as stated earlier, you should 
configure DHCP on only one server in the cluster. 


Because all DHCP configuration information and IP address ranges are stored in eDirectory, no 
shared storage is required to run DHCP with Novell Cluster Services. 


Any server in the cluster that will run DHCP must have at least a Read/Write eDirectory replica. 
This allows Novell Cluster Services to modify DHCP-specific eDirectory objects regardless of 
which server in the cluster holds the objects. 


Novell Cluster Services Configuration and Setup 


After DHCP is properly configured on one server in your cluster, you must create and configure a 
DHCP resource in Novell Cluster Services. This includes configuring DHCP load and unload 
scripts, setting DHCP Failover and Failback modes, and assigning the DHCP resource to specific 
servers in your cluster. 
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Creating a DHCP Cluster Resource 


Novell Cluster Services includes a DHCP resource template, which greatly simplifies the process 
for creating a DHCP cluster resource. Much of the DHCP cluster resource configuration is 
perfomed automatically by the DHCP resource template. 


To create a cluster resource: 
4 In ConsoleOne®, browse to and select the Cluster object. 
2 Click File > New > Cluster > Cluster Resource. 
3 Enter a name for the DHCP cluster resource. 
4 


Enter the DHCP template name in the Inherit from Template field, or browse and select it from 
the list. 


5 Check the Define Additional Properties check box, click Create, and then continue with 
“Editing DHCP Load and Unload Scripts” on page 20. 


The DHCP resource template configures the DHCP resource by automatically creating DHCP 
load and unload scripts, setting failover and failback modes, and assigning DHCP as a 
resource to all nodes in the cluster. 


Editing DHCP Load and Unload Scripts 


The DHCP resource template automatically creates a load and unload script to start and stop the 
DHCP service on servers in your cluster. The load script contains commands that you must 
customize for your specific DHCP configuration. 


To edit the DHCP load script: 
1 In ConsoleOne, right-click the DHCP Resource object and then click Properties. 


If you just created the DHCP resource object and checked the Define Additional Properties 
check box, the DHCP Resource object should already be displayed. 


2 Click the Scripts tab on the property page and select Cluster Resource Load Script. 
The load script will appear similar to the following example: 


CLUSTER DHCP CN=SERVER.O=ORG.T=TREE 
dhcpsrvr --servaddr=A.B.C.D 


The CLUSTER DHCP command is necessary to pass DHCP-specific configuration 
information to another server in the cluster if the server where DHCP is running fails. 


The DHCPSRVR command and command switches are used to start the DHCP server 
(dhcpsrvr.nlm) on a NetWare server. 


3 Edit the CLUSTER DHCP command to add the context of the Server object for the server in 
your cluster that has DHCP configured. 


For example, if the server context is CN=PROD1.0=SALES.T=ACME TREE, the line in the 
load script would appear as follows: 


CLUSTER DHCP CN=PROD1.0=SALES .T=ACME TREE 


The server context specified in the load script does not change even though the load script will 
run on another server in the cluster during a failover. 


4 Fdit the DHCPSRVR command to assign an IP address to the DHCP cluster resource. 
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For example, if the IP address for the DHCP cluster resource is 151.152.153.10, the line in the 
load script would appear as follows: 


dhcp --servaddr=151.152.153.10 


The IP address for the DHCP cluster resource allows clients to reconnect to that address 
regardless of which server is hosting it. 


5 Click the Unload Script tab on the property page to view the unload script. 
The UNLOAD DHCPSRVR command is by default the only command in the unload script. 


Setting DHCP Start, Failover, and Failback Modes 


The DHCP resource template sets the DHCP resource Start Mode and Failover Mode to AUTO, 
and the Failback Mode to DISABLE. 


If the DHCP resource Start Mode is set to AUTO, the DHCP server automatically loads on a 
designated server when the cluster is first brought up. If the DHCP Start Mode is set to MANUAL, 
you can manually start DHCP on a specific server when you want, instead of having it 
automatically start when servers in the cluster are brought up. 


If the DHCP Failover Mode is set to AUTO, the DHCP server automatically moves to the next 
server in the Assigned Nodes list in the event of a hardware or software failure. If the DHCP 
Failover Mode is set to Manual, you can intervene after a failure occurs and before the DHCP 
server is started on another node. 


If the DHCP Failback Mode is set to DISABLE, the DHCP server will continue running on the 
node it has failed to. If the DHCP Failback Mode is set to AUTO, the DHCP server automatically 
moves back to its preferred node when the preferred node is brought back online. Set the DHCP 
Failback Mode to MANUAL to prevent the DHCP server from moving back to its preferred node 
when that node is brought back online, until you are ready to allow it to happen. 


To view or change DHCP Start, Failover, and Failback modes, do the following: 
1 In ConsoleOne, right click the DHCP Resource object and select Properties. 
2 Click the Policies tab on the property page. 

3 View or change the Start, Failover, or Failback modes for DHCP. 


View or Edit DHCP Resource Server Assignments 


The DHCP resource template automatically assigns the DHCP resource to all nodes in the cluster. 
The order of assignment is the order the nodes appear in the resource list. To view or edit DHCP 
resource node assignments or change the server failover order: 


1 In ConsoleOne, right-click the DHCP Resource object and select Properties. 
2 Click the Nodes tab on the property page. 


3 View the current DHCP resource server assignments and, if necessary, click the right or left 
arrow button to assign or unassign servers to the DHCP resource. 


You can also click the up or down arrow button to change the failover order of the servers 
assigned to DHCP. 
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Additional Novell Cluster Services Configuration Information 
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If you have DHCP clients that are located on a separate LAN segment or IP subnet from the servers 
in your cluster, some additional configuration is necessary. This additional configuration consists 
of adding and deleting a secondary IP address on the cluster server where DHCP is running and 
setting up your router to forward DHCP requests. 


To add a secondary IP address: 
1 Edit the DHCP cluster resource load script and add the following line: 
ADD SECONDARY IP ADDRESS A.B.C.D 


Replace A.B.C.D with a unique IP address. Your router will forward DHCP requests from 
other LAN segments to this address. 


2 Edit the DHCP cluster resource unload script and add the following line: 
DEL SECONDARY IP ADDRESS A.B.C.D 


Replace A.B.C.D with the same IP address you added in the load script. 


To configure a router to forward DHCP requests, see your router documentation. If you are using 
a NetWare server as a router, ensure the following line is added to the autoexec.ncf file of the server 
acting as a router: 


BOOTPFWD SERVER=A.B.C.D 
Replace A.B.C.D with the secondary IP address you specified in the load and unload scripts above. 


For additional information on setting up and configuring Novell Cluster Services, See the Novell 
Cluster Services 1.7 Administration Guide. 
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Configuring iPrint with Novell Cluster Services 


This section will help you do the following 
+ Understand the benefits of high availability printing 
+ Create and configure a broker and a print manager 


+ Configure the print cluster volume 


Benefits of High Availability Printing 


Running iPrint on a NetWare cluster provides the following benefits: 
+ Centralized management 


+ Byconfiguring the Print Management Database to reside on a shared disk cluster volume, 
you no longer need to replicate information to achieve high availability. 


+ The cluster console GUI allows you to monitor and control the location of cluster 
volumes with the Broker and Print Manager services using them from a single 
management workstation. 


+ Because cluster volumes are tightly consistent and highly available, distributed print 
management tasks are simplified. 


+ Automatic restart of print services 


+ Ifa server fails, the cluster volume containing the Print Management Database and spool 
area automatically remounts on a surviving server in the cluster. The Broker and Print 
Manager NLM™ software will also automatically restart without user intervention. 


+ On restart, the Broker and Print Manager will discover the Print Management Database 
on a cluster volume mounted on their server. Because the cluster volume is the same 
regardless of which server it is mounted on, no print-related information is lost or out of 
date. 


Ensure that iPrint Is Installed 


iPrint must be installed before installing Novell® Cluster Services™. During the installation of 
NetWare 6.5, you must select to install iPrint. 
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Creating and Configuring a Broker and Print Manager 


Before running iPrint in a cluster environment, you must create a Broker and Print Manager on the 
cluster-enabled volume. You should dedicate a volume for printing. 


To create a Broker and Print Manager, use iManager. 
To prepare the print volume for a print broker: 
1 Using Windows* Explorer, browse and select the Print volume in the eDirectory™ tree. 
This creates a client connection to the server currently hosting the volume. 


2 From a server’s local volume, copy the sys:ndps directory and subdirectories to the root 
directory of the shared cluster volume created for printing. 


Ensure that \ndps is the top -evel directory at the root of the Print volume. 
To create a Broker using iManager: 
1 From iManager, click iPrint Management > Create Broker. 
2 Fill in the fields. 


For the RMS Volume, select the shared cluster volume created for printing. 


NOTE: You cannot create a Broker object until you have copied the resource directory as explained in 
Step 2 in the above instructions for preparing the print volume for a print broker. 


For more information, see Creating a Broker in the Novell iPrint Administration Guide for 
NetWare 6.5. 


To create a Print Manager: 
1 From iManager, click iPrint Management > Create Print Manager. 
2 Fill in the fields. 
For the Database Volume select the shared cluster volume created for printing. 


For more information, see Creating a Print Manager in the Novell iPrint Administration Guide 
for NetWare 6.5. 


Configuring the Print Cluster Volume 


After you have created a Broker and Print Manager, you must complete the following 
configuration tasks: 
+ “Configuring the Print Volume Load and Unload Scripts” on page 24 


+ “Setting Print Volume Server Assignments” on page 25 


+ “Setting Start, Failover, and Failback modes for Printing” on page 26 


Configuring the Print Volume Load and Unload Scripts 


Load and unload scripts are required by Novell Cluster Services to start and stop iPrint and mount 
the print volume on servers in the cluster. 


To configure the print volume load and unload scripts: 


1 In ConsoleOne®, select Print Cluster Volume Object. 
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2 Right-click the Virtual server object and select Properties. 


3 Click the Load Script tab on the property page and add the following lines to the end of the 
load script. 


LOAD BROKER.broker name.broker context /ALLOWDUP 


LOAD NDPSM .manager name.manager context /DBVOLUME=NOCHECK / 
IPADDRESS=secondary cluster address 


Replace broker name and broker context with the Broker object’s name and context; replace 
the manager_name and manager_context with the Print Manager’s name and context; replace 
secondary_cluster_address with the IP address assigned to the cluster-enabled volume. 


The /ALLOWDUP command line switch instructs the Broker to avoid its check for duplicate 
Brokers at start-up. Because Novell Cluster Services ensures that only one Broker NLM runs 
and references the same eDirectory Broker configuration object at a time, this option allows 
the Broker to start faster without human intervention by avoiding a communication timeout. 


The /DBVOLUME=NOCHECK command line switch instructs the Print Manager to avoid 
checking whether its database volume is local or remote. This switch allows the Print Manager 
to simply open the cluster volume identified in its eDirectory configuration object. 


The /IPADDRESS command line switch assigns the cluster-enabled volume’s IP addresses to 
the Print Manager. 


4 Click the Unload Script tab on the Property page and add a line to dismount the print volume 
from a server. In addition, add the following lines to the beginning of the unload script. 


UNLOAD NDPSM 


UNLOAD BROKER 


NOTE: If you upgraded an existing cluster to NetWare 6.5 instead of creating a new cluster, the following 
entries are no longer needed and should be removed from the load and unload scripts. 


HTTPBIND secondary cluster address /KEYFILE:”SSL CertificateIP” 


HTTPUNBIND secondary cluster address 


Setting Print Volume Server Assignments 


Novell Cluster Services by default assigns the print volume resource to all nodes in the cluster. The 
order of assignment is the order the nodes appear in the resource list. To view or edit the print 
volume resource node assignments or change the server failover order, do the following: 


1 In ConsoleOne, right-click the print volume resource object and select Properties. 
2 Click the Nodes tab on the property page. 


3 View the current print volume resource server assignments, and if necessary, click the right or 
left arrow button to assign or unassign servers to the print volume resource. 


You can click the up or down arrow button to change the failover order of the servers assigned 
to the print volume. 


IMPORTANT: In order for the Broker to load and enable the Resource Management Service properly you 
must ensure that the IP address of the print volume is added to the \etc\hosts file of each server in the cluster 
that will host the print volume. 


Use a text editor to open the hosts file and if necessary add the IP address you assigned to the print volume 
resource when you cluster-enabled it. For example, if the print cluster volume is named cluster printvol server 
and the IP address for that cluster volume is 137.65.119.70, you would add the following line: 


137.65.119.70 cluster printvol server 
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Setting Start, Failover, and Failback modes for Printing 


Novell Cluster Services by default sets the print cluster volume Start Mode and Failover Mode to 
Auto, and the Failback Mode to Disable. If the print volume Start Mode is set to Auto, iPrint 
automatically starts on a server when the cluster is first brought up. If the print volume Start Mode 
is set to Manual, you must manually start print on a server when you want, instead of having it 
automatically start when servers in the cluster are brought up. 


If the print volume Failover Mode is set to Auto, iPrint automatically starts on the next server in 
the Assigned Nodes list in the event of a hardware or software failure. If the print volume Failover 
Mode is set to Manual, you can intervene after a failure occurs and before iPrint is moved to 
another node. 


If the print volume Failback Mode is set to Disable, iPrint will not fail back to its most preferred 
node when the most preferred node rejoins the cluster. If the print volume Failback Mode is set to 
Auto, iPrint will automatically fail back to its most preferred node when the most preferred node 
rejoins the cluster. Generally, you want a failback to a preferred node to occur after business 
hours. You can set the print volume Failback Mode to Manual to prevent iPrint from moving back 
to its preferred node when that node is brought back online, until you are ready to allow it to 
happen. 


IMPORTANT: We recommend you use the default settings for Start, Failover and Failback modes. 
To view or change the print volume Start, Failover, and Failback modes: 
1 In ConsoleOne, right-click the Print Volume Resource object and select Properties. 
2 Click the Policies tab on the property page. 


3 View or change the Start, Failover or Failback modes for the print volume. 


Using iPrint in a Clustered Environment 
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If you are using the default iPrint configurations or are embedding URLs in your iPrint Web pages, 
you need to be aware of the following: 


+ Ifyou are using custom map files that are saved in sys:\apache2\htdocs\ippdocs\images\maps, 
you must copy the maps to each file server in the cluster that is hosting iPrint. This will make 
the maps available if a failover occurs. 


¢ Links to the default iPrint page or other custom pages in \ippdocs should use the secondary IP 
address or DNS name of the cluster volume. This address moves with the volume to other 
servers in the cluster during a failover. 


+ When adding drivers to Resource Management Service, make sure that the files in the 
ndps\resdir directory are not flagged as read-only. This is not an issue when copying the \resdir 
to sys:; however, if you extract the files from the .zip files on the NetWare 6.5 Products CD 
(CD2), the directories might be flagged read-only. 
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Configuring NetStorage with Novell Cluster 
Services 


NetStorage provides secure Internet-based access to files and folders on a NetWare® server on 
your network using either a browser or Microsoft Web Folders (Microsoft’s implementation of 
WebDAV). If the NetWare 6.5 server running NetStorage goes down, Internet-based access to files 
and folders will not be possible. Configuring NetStorage with Novell® Cluster Services™ ensures 
Internet-based access to files and folders can continue even if a server running NetStorage goes 
down. 


NetStorage Installation and Configuration 


Novell NetStorage software is included with NetWare 6.5 and can be installed during the NetWare 
6.5 installation. You must select the Customized NetWare Server installation option and check the 
Novell NetStorage component check box to install NetStorage during the NetWare 6.5 installation. 
Because NetStorage requires Apache, you must also select the Apache Web server check box. See 
the NetWare 6.5 NetStorage Administration Guide for more information on installing and 
configuring NetStorage. 


Because most networks require NetStorage on only one server, it is generally only necessary to 
install NetStorage on two servers in the cluster. Users gain access to files and folders by connecting 
to one NetStorage server. The other NetStorage server acts as a backup in case the first NetStorage 


server fails. The following figure shows how a typical NetStorage cluster configuration might 
look. 


Figure 3 NetStorage Cluster Configuration 
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When you install NetStorage with NetWare 6.5, you are asked to specify the DNS name or IP 
address of the primary eDirectory server. This is the IP address or registered DNS name of a server 
in your eDirectory tree that has the master replica or a read/write replica of eDirectory. If you have 
Novell iFolder® installed on your network, you are also asked to specify the DNS Name or IP 
Address of for iFolder. For NetStorage to function properly in a cluster, you must specify same 
DNS name or IP address of the primary eDirectory server on all servers in the cluster that have 
NetStorage installed. The same is true for iFolder. If you have iFolder installed, you must also 
specify the same iFolder DNS name or IP address on all servers in the cluster. 


Any NetStorage-specific configuration changes made to one NetStorage server must be made on 
all other NetStorage servers in the cluster. In order for NetStorage to function properly with Novell 
Cluster Services, all NetStorage servers in the cluster must be identically configured. 


Novell Cluster Services Configuration and Setup 


Novell Cluster Services must be installed and running on the servers that have NetStorage installed 
before performing the remainder of the NetStorage and Novell Cluster Services configuration. 


Because NetStorage is installed and configured identically on the cluster servers where it will run 
and because that configuration information is stored on each server, no shared storage is required 
to run NetStorage with Novell Cluster Services. 


Creating a NetStorage Cluster Resource 


A cluster resource containing a secondary IP address is necessary to ensure that users continue to 
have access to NetStorage should a server running NetStorage go down. 


Novell Cluster Services includes a Generic IP Service resource template, which simplifies the 
process for creating a NetStorage cluster resource. 


4 In ConsoleOne®, browse to and select the Cluster object. 
2 Click File > New > Cluster > Cluster Resource. 

3 Enter a name for the NetStorage cluster resource. 
4 


Enter the Generic IP Service resource template name in the Inherit from Template field, or 
browse and select it from the list. 


5 Check the Define Additional Properties check box, click Create, then continue with 
“Configuring NetStorage with Novell Cluster Services” on page 27. 


The Generic IP Service resource template helps configure the NetStorage cluster resource by 
automatically creating load and unload scripts, setting failover and failback modes, and 
assigning the resource to all nodes in the cluster. 


You should assign the resource only to those nodes in the cluster that have NetStorage 
installed and running. 


Editing NetStorage Load and Unload Scripts 


The Generic IP Service resource template automatically creates a load and unload script to start 
and stop the NetStorage resource on servers in your cluster. The load script contains commands 
that you must customize for your specific NetStorage configuration. 


To edit the NetStorage load and unload scripts: 
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1 In ConsoleOne, right-click the NetStorage Resource object, then click Properties. 


If you just created the NetStorage resource object and checked the Define Additional 
Properties check box, the NetStorage Resource object should already be displayed. 


2 Click the Scripts tab on the property page, then select Cluster Resource Load Script. 


The load script includes instructions and commands, all of which should currently be 
commented out with the # symbol. 


3 Uncomment the following line by removing the # symbol. 
#add secondary ipaddress A.B.C.D 
4 Replace A.B.C.D with the IP address you want to assign to the NetStorage resource. 


For example, if the IP address for the NetStorage cluster resource is 151.152.153.10, the line 
in the load script would now appear as follows: 


add secondary ipaddress 151.152.153.10 


Clients will now use the NetStorage cluster resource IP address as part of the URL to access 
NetStorage instead of the NetStorage server’s IP address or DNS name. 


5 Click Unload Script on the Scripts tab on the property page to edit the unload script. 


All instructions and commands in the unload script should currently be commented out with 
the # symbol, like they are in the load script. 


6 Uncomment the following line by removing the # symbol. 
#del secondary ipaddress A.B.C.D 


7 Replace A.B.C.D with the IP address you want to assigned to the NetStorage resource in Step 
4 on page 29. 


For example, if the IP address for the NetStorage cluster resource is 151.152.153.10, the line 
in the unload script would now appear as follows: 


del secondary ipaddress 151.152.153.10 


Setting the NetStorage Resource Start, Failover, and Failback Modes 


The Generic IP Service resource template sets the NetStorage resource Start Mode and Failover 
Mode to AUTO, and the Failback Mode to DISABLE. 


If the NetStorage resource Start Mode is set to AUTO, the resource automatically starts on a 
designated server when the cluster is first brought up (the secondary IP address specified in the 
resource is automatically added to the server). If the NetStorage resource Start Mode is set to 
MANUAL, you can manually start the resource on a specific server when you want, instead of 
having it automatically start when servers in the cluster are brought up. 


If the NetStorage resource Failover Mode is set to AUTO, the NetStorage resource automatically 
moves to the next server in the Assigned Nodes list in the event of a hardware or software failure. 
If the NetStorage resource Failover Mode is set to MANUAL, you can intervene after a failure 
occurs and before the resource is started on another node. 


If the NetStorage resource Failback Mode is set to DISABLE, the resource will continue running 
on the node it has failed to. If the NetStorage resource Failback Mode is set to AUTO, the resource 
automatically moves back to its preferred node when the preferred node is brought back online. 
Set the NetStorage resource Failback Mode to MANUAL to prevent the resource from moving 
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back to its preferred node when that node is brought back online, until you are ready to allow it to 
happen. 


To view or change the NetStorage resource Start, Failover, and Failback modes: 
1 In ConsoleOne, right-click the NetStorage Resource object, then select Properties. 
2 Click the Policies tab on the property page. 


3 View or change the Start, Failover, or Failback modes for the NetStorage resource. 


Viewing or Editing NetStorage Resource Server Assignments 


The Generic IP Service resource template automatically assigns the NetStorage resource to all 
nodes in the cluster. The order of assignment is the order the nodes appear in the resource list. You 
should assign the NetStorage resource only to those servers in the cluster that have NetStorage 
installed. 


To view or edit the NetStorage resource node assignments or change the server failover order: 
1 In ConsoleOne, right-click the NetStorage Resource object, then select Properties. 
2 Click the Nodes tab on the property page. 


3 View the current NetStorage resource server assignments and, if necessary, click the right- 
arrow or left-arrow button to assign or unassign servers to the resource. 


You can also click the up or down arrow button to change the failover order of the servers 
assigned to NetStorage. 


Accessing NetStorage After Cluster Configuration 
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To access NetStorage after configuring it with Novell Cluster Services you should inform your 
clients to use the NetStorage cluster resource IP address as part of the URL to access NetStorage 
instead of the NetStorage server’s IP address or DNS name. For more information on accessing 
NetStorage, see Using NetStorage in the NetWare 6.5 NetStorage Administration Guide 
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Configuring Novell exteNd Application Server 
and MySQL with Novell Cluster Services 


Novell® exteNd™ Application Server requires MySOL*, so this document includes instructions 
for configuring both applications with Novell Cluster Services™. 


Benefits of Configuring the exteNd Application Server and MySQL 
for High Availability 


Novell exteNd Application Server provides the foundation for building and deploying cross- 
platform, high-performance, standards-based applications. MySQL is an open source, structured 
query language (SQL) database. If the NetWare” 6.5 server running the exteNd Application Server 
or MySOL goes down, the services and databases provided by exteNd Application Server and 
MySQL will not be accessible unless they are in a clustered environment. Configuring exteNd 
Application Server and MySOL with Novell Cluster Services ensures that they are scalable and 
highly available. 


Novell Cluster Services Configuration and Setup 


NetWare 6.5 and Novell Cluster Services 1.7 must be installed before configuring exteNd 
Application Server and MySQL to run with Novell Cluster Services. NetWare 6.5 includes Novell 
Cluster Services 1.7 and licenses for two cluster nodes. 


After Novell Cluster Services is installed, you must create and cluster-enable a pool/volume for 
the MySOL and exteNd Application Server databases. Creating a cluster-enabled pool/volume 
resource in Novell Cluster Services also reguires you to configure volume resource load and 
unload scripts, set volume resource Failover and Failback modes, and assign the volume resource 
to specific servers in your cluster. 


Creating and Cluster-Enabling a Pool/Volume Resource 


You must already have an NSS partition created on a device that is sharable for clustering (shared 
disk system or SAN) prior to creating and cluster-enabling a pool/volume. For more information 
on creating cluster partitions on shared storage, see Create Shared Disk Partitions in the Novell 
Cluster Services 1.7 Administration Guide. 


Only one NSS pool can be created on a partition. Storage pools can be cluster-enabled at the same 
time they are created or they can be cluster-enabled at a later time after they are created. 


To create and cluster-enable a pool at the same time: 


1 From the NSSMU main menu, select Pools, press Insert, then type a name for the new pool 
you want to create. 


2 Select the partition on your shared storage where you want the pool created. 
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3 Choose to activate and cluster-enable the pool when it is created. 


The Activate on Creation feature is enabled by default. This causes the pool to be activated as 
soon as it is created. If you choose not to activate the pool, you must manually activate it later 
before it can be used. 


The Cluster Enable on Creation feature is also enabled by default. To cluster-enable the pool 
at the same time it is created, accept the default entry (Yes). 


4 Specify the Virtual Server Name, IP Address, Advertising Protocols and, if necessary, the 
CIFS Server Name. 


When you cluster-enable a pool, a virtual Server object is automatically created and given the 
name of the Cluster object plus the cluster-enabled pool. For example, if the cluster name is 
cluster] and the cluster-enabled pool name is pooll, then the default virtual server name will 
be clusterl_pooll_server. You can edit the field to change the default virtual server name. 


Each cluster-enabled NSS pool requires its own IP address. The IP address is used to provide 
access and failover capability to the cluster-enabled pool (virtual server). The IP address you 
assign to the pool remains assigned to the pool regardless of which server in the cluster is 
accessing the pool. 


You can select one or all of the advertising protocols. NCP™ is the protocol used by Novell 
clients, CIFS is the protocol used by Microsoft* clients, and AFP is the protocol used by 
Macintosh* clients. Selecting any of the protocols will cause lines to be added to the pool 
resource load and unload scripts to activate the selected protocols on the cluster. This lets you 
ensure that the cluster-enabled pool you just created is highly available to all your clients. 


If you select CIFS as one of the protocols, a CIFS Server Name is also required. This is the 
server name CIFS clients see when they browse the network. A default server name is listed, 
but you can change the server name by editing the text in the field. 


5 Select Create to create and cluster-enable the pool. 


If you have already created a pool and want to cluster-enable it, see Cluster Enable Pools and 
Volumes in the Novell Cluster Services 1.7 Administration Guide. 


Editing Cluster Volume Load and Unload Scripts 


When you cluster-enable a pool or volume, commands are automatically added to the pool load 
and unload scripts to start and stop the pool resource on servers in your cluster. In addition to the 
commands to start and stop the pool resource, you must add commands to start and stop the 
Application Server and MySQL. 


To edit the pool load script: 
1 In ConsoleOne®, right-click the Pool Resource object, then click Properties. 


If you just created or cluster-enabled the cluster pool and checked the Define Additional 
Properties check box, the cluster pool object should already be displayed. 


2 Click the Scripts tab on the property page, then select Cluster Resource Load Script. 
The load script will appear similar to the following example: 


nss /poolactivate=POOL1 

mount VOL1 VOLID=254 

CLUSTER CVSBIND ADD CLUSTER1_POOL1_SERVER 151.152.101.190 
NUDP ADD CLUSTER1_POOL1_SERVER 151.152.101.190 

add secondary ipaddress 151.152.101.190 
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3 Add the following lines to the end of the load script . 


mysqld_safe bind_ipaddress=a.b.c.d --autoclose 


load silverserver.nlm 
Replace a.b.c.d with the IP address you assigned to the cluster-enabled volume. 


For example, if the IP address for the cluster volume resource is 151.152.101.10, the line in 
the load script would appear as follows: 


mysqld_safe bind_ipaddress=151.152.101.10 --autoclose 


If you are not configuring exteNd Application Server, the load silverserver.nlm line should not 
be added. 


4 Click the Unload Script tab on the property page and add the following lines to the beginning 
of the unload script. 


unload silverserver.nlm 


unload mysqld 


If you are not configuring exteNd Application Server, don’t add the unload silverserver.nlm 
line. 


Setting Cluster Volume Start, Failover, and Failback Modes 


When you cluster enable a pool/volume, Novell Cluster Services sets the pool resource Start Mode 
and Failover Mode to AUTO, and the Failback Mode to DISABLE. 


If the pool resource Start Mode is set to AUTO, the cluster pool automatically starts on a 
designated server when the cluster is first brought up. If the cluster pool/volume Start Mode is set 
to MANUAL, you can manually start the cluster pool/volume on a specific server when you want, 
instead of having it automatically start when servers in the cluster are brought up. 


If the cluster pool Failover Mode is set to AUTO, the cluster pool/volume automatically moves to 
the next server in the Assigned Nodes list in the event of a hardware or software failure. If the 
cluster pool/volume Failover Mode is set to Manual, you can intervene after a failure occurs and 
before the pool/volume is started on another node. 


If the cluster pool/volume Failback Mode is set to DISABLE, the cluster pool/volume will 
continue running on the node it has failed to. If the cluster pool/volume Failback Mode is set to 
AUTO, the cluster pool/voume automatically moves back to its preferred node when the preferred 
node is brought back online. Set the cluster pool/volume Failback Mode to MANUAL to prevent 
the pool/volume from moving back to its preferred node when that node is brought back online, 
until you are ready to allow it to happen. 


To view or change cluster pool/volume Start, Failover, and Failback modes: 
1 In ConsoleOne, right-click the cluster pool resource object, then select Properties. 
2 Click the Policies tab on the property page. 


3 View or change the Start, Failover, or Failback modes for the cluster-enabled pool/volume. 
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Viewing or Editing Cluster Volume Resource Server Assignments 


When you cluster-enable a pool/volume, the volume resource is automatically assigned to all 
nodes in the cluster. The order of assignment is the order the nodes appear in the resource list. To 
view or edit the cluster pool/volume resource node assignments or change the server failover 
order: 


1 In ConsoleOne, right-click the cluster pool resource object, then select Properties. 
2 Click the Nodes tab on the property page. 


3 View the current cluster pool resource server assignments and, if necessary, click the right or 
left arrow button to assign or unassign servers to the cluster pool/volume resource. 


You can also click the up or down arrow button to change the failover order of the servers 
assigned to cluster pool/volume. 


MySQL and exteNd Application Server Configuration and Setup 


Before configuring exteNd Application Server and MySQL with Novell Cluster Services, both 
exteNd Application Server and MySQL must be installed and configured properly on all servers in 
the cluster where you intend to have them run. For instructions on installing and configuring 
exteNd Application Server with NetWare 6.5, see the exteNd Application Server documentation 
(http://www.novell.com/documentation/lg/extendas50/index.html). For instructions on installing 
and configuring MySQL with NetWare 6.5, see the MySOL Administration Guide for NetWare 6.5. 


exteNd Application Server and MySQL software is included with NetWare 6.5. You should select 
the Customized NetWare Server installation option and check the MySQL and exteNd Application 
Server component check boxes to install both products during the NetWare 6.5 installation. You 
can also use the exteNd J2EE* Web Application Server Pre-Configured Server option to install 
both MySQL and the exteNd Application Server during the NetWare 6.5 installation. You cannot 
install MySQL or exteNd Application Server with the Basic NetWare File Server installation 
option. 


In order for exteNd Application Server and MySQL to function properly in a cluster, the database 
data must reside on a cluster-enabled volume (virtual server). This means that a shared storage 
system (SAN) is required. 


Edit Autoexec.ncf Files 


When you install MySQL and exteNd Application Server, commands are added to the autoxec.ncf 
file on the server to automatically start both programs when the NetWare server starts. Because 
Novell Cluster Services starts and stops the programs, these commands must be removed or 
commented out from each server in the cluster where they are installed. 


Edit the autoexec.ncf file on each server in the cluster where MySQL and exteNd Application 
Server are installed and comment out or remove the following lines: 


mysqld_safe --autoclose 
load silverserver.nlm 


If you are only configuring MySQL, and do not have exteNd Application Server installed, the load 
silverserver.nlm line will not be present. 
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Configure MySQL on the Cluster-Enabled Volume 


In order for MySQL to take advantage of the benefits provided by Novell Cluster Services, you 
must make some configuration changes to MySQL. These configuration changes include editing 
a MySQL configuration file to change the MySQL data directory to point to the cluster-enabled 
volume and installing the MySQL database on the shared volume. 


These instructions assume no database has been created. If a MySQL database currently exists, the 
database must be moved to the cluster-enabled volume, rather than creating it as described in Step 
3 on page 35. 


1 On all cluster nodes where MySQL is installed, use a text editor to open the sys:\etc\my.cnf 
file and change the MySQL data directory to point to the directory you will create on the 
cluster-enabled volume. 


For example, the current line should read: 

datadir=sys:/mysql/data 

If you named the cluster-enabled volume voll, you would change the line to read: 
datadir=voll:/mysql/data 


2 On the server in the cluster that has the cluster-enabled volume mounted, create a mysql\data 
directory at the root of the cluster volume. 


3 On the server in the cluster that has the cluster-enabled volume mounted, enter 
mysgld install dbat the server console. 


This installs the MySQL database on the shared volume. 


4 Check the mysql\data directory on the cluster-enabled volume to ensure that the MySQL 
database was created. 


Configure exteNd Application Server on the Cluster-Enabled Volume 


Some exteNd Application Server configuration changes are also required in order for it to function 
properly in a cluster. These configuration changes include changing the jdbc URL to cause the 
MySQL SilverMaster to point to the cluster-enabled volume and creating the SilverMaster 
database on the cluster-enabled volume. 


These instructions assume no database has been created. If SilverMaster databases currently exist, 
the databases must be moved to the cluster-enabled volume, rather than creating them as described 
in Step 2 on page 35. 


1 Onall cluster nodes where exteNd Application Server is installed, use a text editor to open the 
sys:/exteNd/AppServer/Resources/httpd.props file and change the jdbc URL to point to the 
directory you will create on the cluster-enabled volume. 


For example, if the DNS name for the server is serverl.acme.com, the current line should 
read: 


http-server.Jdbc. URL=jdbc:mysql://server1.acme.com/SilverMaster50 


If the cluster-enabled volume (virtual server) name is cluster] pooll server, you would 
change the line to read: 


http-server.Jdbc.URL=jdbc:mysql://clusterl_pooll_server/SilverMasterS0 


2 On the server in the cluster that has the cluster-enabled volume mounted, enter 
silvermasterinit at the server console. 
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This creates the SilverMaster database on the cluster-enabled volume. 


If you have secured the SilverMaster database, you must supply a username and password 
when running SilverMasterInit. To add a username and password you would type 
silvermasterinit -u username -p password. 


3 Check the mysql\data directory on the cluster-enabled volume to ensure that the 
SilverMaster50 database was created. 


Starting MySOL and exteNd Application Server in the Cluster 


To start MySOL and exteNd Application Server in the cluster you must unload MySOL and App 
Server from all servers in the cluster where they are installed, and then bring the cluster-enabled 
volume resource offline and online again. 


1 At the server console of each server in the cluster where MySQL and exteNd Application 
Server are installed and running, type unload silverserver and then unload 
mysqld. 


If you are configuring only MySQL, it is not necessary to unload silverserver. 


2 At the server console of the machine that has the cluster-enabled volume mounted, enter 
cluster offline pooll_server. 


Replace pooll_ server with the name of the cluster-enable pool. 
3 At the same server console, enter cluster online pooll server. 
Again, replace pooll server with the name of the cluster-enable pool. 


When you bring the cluster enabled volume resource back online MySOL and exteNd 
Application Server will start on a specified node in the cluster. 


Additional Novell Cluster Services Configuration Information 


For additional information on setting up and configuring Novell Cluster Services, see the Novell 
Cluster Services 1.7 Administration Guide. 
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